home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
system
/
swell100.zip
/
SWELL.DOC
< prev
next >
Wrap
Text File
|
1989-07-06
|
33KB
|
994 lines
Contents
1 Abstract . . . . . . . . . . . . . . . . . . . 1
2 Introduction . . . . . . . . . . . . . . . . . 1
3 Usage . . . . . . . . . . . . . . . . . . . . . 1
3.1 SWELL.EXE . . . . . . . . . . . . . . . . 1
3.2 SwellCFG.EXE . . . . . . . . . . . . . . . 2
3.3 MemMap (MM.EXE) . . . . . . . . . . . . . 3
4 Where did my TSR go? . . . . . . . . . . . . . 4
5 Turbo Trouble . . . . . . . . . . . . . . . . . 5
6 Possible Uses . . . . . . . . . . . . . . . . . 5
6.1 Lotus 123 . . . . . . . . . . . . . . . . 5
6.2 MAKE.EXE / Microsoft C Compiler . . . . . 5
6.3 Text editor with a Compiler . . . . . . . 5
6.4 Debuggers . . . . . . . . . . . . . . . . 6
6.5 Bulletin Board Systems (BBS) . . . . . . . 6
7 Problems . . . . . . . . . . . . . . . . . . . 6
7.1 Special Situations . . . . . . . . . . . . 7
7.2 Communications Programs . . . . . . . . . 7
7.3 Local Area Networks (LANs) . . . . . . . . 7
8 Disclaimer . . . . . . . . . . . . . . . . . . 8
9 License . . . . . . . . . . . . . . . . . . . . 8
9.1 Registered Version . . . . . . . . . . . . 8
9.2 Demonstration Version . . . . . . . . . . 8
10 Registration . . . . . . . . . . . . . . . . . 9
10.1 Prices . . . . . . . . . . . . . . . . . 9
10.2 Order Form . . . . . . . . . . . . . . 10
11 For more information: . . . . . . . . . . . 11
Index 13
1 Abstract
SWELL transparently swaps a program out of memory onto disk when
a child program is loaded. This allows a program to run other
programs even if there is not enough RAM for them to occupy
simultaneously.
2 Introduction
This program alleviates memory constraints under certain
conditions. The following example will help illustrate: Many
word processors (Sprint, WordPerfect) come with conversion
utilities that run externally. If you have 300k of free memory
and your word processor uses 250k, this leaves 50k for the
conversion utility to operate. It may not be enough!
When SWELL is active, it will swap the word processor session out
to disk before loading the conversion utility (leaving the full
300k free for the conversion utility to operate) then reload the
wordprocessing session at the completion of the conversion. The
wordprocessor will not be aware that it was put into limbo while
the conversion utility was running.
The results are obvious: SWELL can allow programs to work when
they would not work before.
3 Usage
3.1 SWELL.EXE
SWELL is a TSR (Terminate and Stay Resident) program that
requires no parameters on the command line. If not already
installed, SWELL will remain in memory after you start it. The
registered version of SWELL uses approximately 9K of memory, the
demonstration version uses approximately 48k.
SWELL will use the root directory of the drive you loaded it from
for its swap files unless you specify one of two environment
variables as follows:
SET TMP=x:\path
or
SET SWELL=x:\path
Both the TMP and SWELL environment variables have the same
effect. If both are specified, SWELL takes precedence over TMP.
If you have extended, EMS or XMS memory, you can create a RAM
disk and point TMP, or SWELL to it. Note that SWELL only looks
for these variables when it is loaded into memory; Changing TMP
or SWELL afterwards will NOT change the path where SWELL swaps
memory. Performance is so high with a ram disk that you will
probably not notice any swapping occurring.
If you have any other TSR programs, you will probably want to
load them before SWELL (this is discussed further in section 4.)
3.2 SwellCFG.EXE
SwellCFG Allows you to view and/or change certain SWELL options.
SwellCFG will only work if SWELL has been loaded into memory.
Starting this program with no parameters brings up the following
help screen:
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ SwellCFG (C) 1989 Peter Fitzsimmons 06-03-89 █
█ Version 1.01 █
█ Usage: SWELLCFG [/d] [/v on|off] [/1] [/s] [/a] [/u] █
█ [/b on|off] █
█ █
█ Purpose: Display/Modify SWELL's (the SWapper shELL) █
█ operating characteristics. █
█ Options: /d - Display current status (no changes). █
█ /v - turn verbose flag off (quiet mode) or on. █
█ /1 - suspend once : don't do any swapping █
█ for the next program that is loaded. █
█ /s - suspend (until reactivated with /a). █
█ /a - activate. █
█ /u - uninstall (remove SWELL from memory). █
█ /b - engage/disengage support for certain █
█ Borland products. █
█ Example: SWELLCFG /a /v off █
█ would ensure that SWELL is active, and is in █
█ quiet mode. █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
Figure 1: The SwellCFG Usage Box
SwellCFG communicates with SWELL through the SWELL Application
Programming Interface (SAPI). Registered users receive the C
source code (Microsoft/Turbo) for SwellCFG, as well as complete
documentation on SAPI. SwellCFG takes the following command line
parameters, in any order:
/d - Displays the status of the verbose flag, the "suspend
once" flag, and the suspended flag.
/v - Changes the status of the verbose flag. When ON, SWELL
will print messages when it is swapping memory out to
disk, loading programs, and swapping data from disk to
memory. When loading a program, SWELL will report how
many bytes of RAM it has saved you so far. Verbose on
is useful when debugging your system, or if you are
curious about SWELL's effectiveness. With the verbose
flag OFF, SWELL is in quiet mode; it will only print
- 2 -
messages during an error condition (ex: swap disk
full). The default is OFF.
/s - This option will suspend SWELL from swapping programs
out to disk. It will NOT stop it from swapping IN any
programs it had swapped out to disk before it was